Skip to content

Conversation

LordPachelbel
Copy link
Contributor

This tripped me up when I was going through this tutorial until I figured out what the namespace was supposed to be.

``@ApiResource()`` annotation::

// src/Entity/Product.php
// ...
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This expression makes explicit that there are some statements which are not exposed at this point in the file.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Although you are right, this is the "Quick Tour" docs, so it's designed for the absolute Symfony newcomer. I think it's better if we show all use and all namesapces in the examples of this section. Let's merge this and I'll review the other examples in a separate PR.

@javiereguiluz javiereguiluz added this to the 4.0 milestone Mar 30, 2018
@javiereguiluz
Copy link
Member

@LordPachelbel thanks for taking care of this. It's a nice fix and shows great attention to detail. Congrats also on your first Symfony Docs contribution.

@javiereguiluz javiereguiluz merged commit 46252b7 into symfony:4.0 Mar 30, 2018
javiereguiluz added a commit that referenced this pull request Mar 30, 2018
This PR was merged into the 4.0 branch.

Discussion
----------

Missing namespace

This tripped me up when I was going through this tutorial until I figured out what the namespace was supposed to be.

Commits
-------

46252b7 The namespace was missing
@LordPachelbel LordPachelbel deleted the patch-1 branch April 3, 2018 01:58
javiereguiluz added a commit that referenced this pull request Apr 3, 2018
…amespaces", etc.) (javiereguiluz)

This PR was merged into the 4.0 branch.

Discussion
----------

Made all examples of "Quick Tour" complete (all "use", "namespaces", etc.)

After #9522 I thought we could make all "Quick Tour" examples complete. This is worse for expert developers ... but I think it's better for newcomers, which are the readers of these articles.

Commits
-------

7ab953c Made all examples of "Quick Tour" complete (all "use", "namespaces", etc.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants